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WELCOME TO 

THE BEAGLt COMPILER] 

The Bi'iigk- Compiler does opt? thing^il rewrites Applesoft UASIC 
prngriinib <~o [hey run fabler, just ss if Ihty v^t-rc wnlti?n in 
machine language, Ma^hino language programs run much taslor 
than Applesoft prugrams bccauBe no time je wasted inierpreiing 
"hviman" command's like home, GOTO, [r,TI[£.\, and so on. 
While Ihe Beagle Compiler doesn't scluiillv convert programs 
inio machine bnguago (ir actually converts them into its own 
language), ihe effect is the same. 

Applesoft BASIC may be slower than machine language, but 
it is fjr easier (for most of u\i) to write programs with-rind it's 
easier lo read. The Bi-Jgle Compiler gives you Lhe best of both 
world s-easy-to-wntG programs and machine language speed. 




BACK JT UP 

The Geagle Compiler di^k is not copy -protected, so you can land 
should] make a backup in cas^e something happens to the 
original- Uw the copy program that came with your Apple, or 
the 35-sccond DlSK.COf'Y program from our Exlra K disk. Vou 
may also transfer fifes from di^k to disk usmg our Big U disk's 
FlLrMOVHH prcgmm or one of Apple's utilities. 

Please don't give copieii of our diski^ and programs away lo 
your friends. Every illegiil copy is a vote for copy protctlion jnd 
againi^t [riendly software. If you plan on giving copies of your 
own compiled programs away, read page 6. 



COMPILER FACTS 

Ju5t liki^ il says in the sd^ ";iher you tiiKJl Ihi; Bf^^\e C:nnpilcr 
disk, you can run almoBt any Applesott program iil m^Khine 
liinguagc i>pcod- F^ST/" 

HOW FAST IS IT? 

Unsdcnlific tGsling shows that compik-d programs tend U> run 
bctwoL'n 2 and 15 limos ss fiisi as Applcsufl programs; it dcpinds 
on what the program aciually dot.'^. Some functions liko firing 
and variable manipul.itions show a [rimcndous spocd increase. 
Olher things hko floaiing point cilculations aren't affoc+cd at all. 

WHEN SHOULDNT YOU COMPILE? 
Machine language speed i^n'l always sn jdviiniagi?-soTnc 
programs, lik<? quc^tion-iind-answcr program*, work |usl fine in 
plain old Applesoft. Too much speed will make many proRram!* 
impO!-5ibli? to u^c. 

Somo programs thai benefit from compiling may have 
certain sections that will ncfd to be ilowod duwn. Since you 
can't compile jost part ot a pTogramn you'll have lu mako 
adjustments \i\ Applesoft bc^fore compiling. 

WHEN CANTVOU COMPILE? 

Most Applestifi programs com pile wiih ease. Occasionally, a 
program will bo loo large to compik- or contain commands that 
aru intompaiibk with the compiling process. 

Non-Applesnft programs won't compile, (You can't compile 
AppleWorks for owmple-it isn't written in Applesoft), 

Copy-proteclfld programs won't compile unless you unprotccl 
them first. Don'l ask us how-we don't know how- 

Dos 3^ programs will usually compile after you convert them 
into l^roDO^ (use erne of Apple's programs to do the converting), 
Make t^ure a converted program works heJOTs you compile it. 
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SFLCIALRUNtFITSOF 

THE BEAGLE COMPILHR 

The Beagle Compiler is belter than any compiler we've ever 

scon. And we've seen a few. 

• Olher compilers do nut support I'rolJOS, 

■ Other compilers wil] nut compile programs "on lh<? spot" 
usmg the standard HUN command. 

• Other compilers produce code that is significantly brgor than 
the originiil program. The Dcagle Compiler doe-i Ihe opposife. 

• Other tompilers tiiko minutes instead of 'seconds to convert 
programs. And then you stilt might have problems. 

■ Other compilers choke on common Applesoft statements like 
![IMI\], [.OMIM, DEKFN, etc. 

• Other copnpilers require many more program changes than 
the Beagle Compiler requires. For example: 

Other compilers would look askance at the above program 
line and make you change it to: 

in MAX=IiJG;DTH AS ( IQU) , BS (1 O;)) , C5 iZOO ) 
Then you have to recompile, 

THERE ARE SOME MEMORY RESTRICTIONS 
Booting the Beagle Compiler disk will coht you about UK of 
main memory- You can cut this figure in half by loading only 
one of the Compiler's two filos-see page 26. 

ABOtJT PROGRAM EDH ORS 

Most Applesoft programmers use somo kind of program editor. 
Unfortunately, you cannut have non-re!oca<ah]e programs like 
Beagle Bros' G.f.LE, [Global program Line Editor) in memory 
with the COMI'|Jj:B,SV5TrM file-sorrVx iherc just isn't room. 
However I'BOGRAM WRITER by Alan Bird (!l will work just fine. 

If you are hooked on Ci.rJ.J:., boot normal ProDOS to use 
C.P.L.E. to write and test pnfgrams, then boot the Beagle Compiler 
to run them at compiled speed. The COMPIUU file (see page Ibi 
cm be in memory with GP.L.i:. as longa^ you install CJ'.f.i:, first, 
then the COMPILER file. 

To use PKa"iKAM WRiTliR. you must install things in the 
proper order: (1) the COM['I[.]'B,SYisTkM tile, (2) PROCJM.M WklTllR- 
language card version, (3) the COMPiL][H file. 




SELLING (OR GIVING AWAY) 
COMlMLtlJ PROGRAMS 

You may Icp-illy ^cl\ or give sway copies oF programs thai ynu 
own and hiivo compiled vvilh ihe Boa^li' Compiler. Sinci.' I he 
Compiler ilscif is pmiccfL-d by copyright ]jws. tht? rL>cipii?nt of 
your pri'sr^^^'^ ^"^' ^^^ ^'^ ^^ 1"^^ "^^" purcha^^'d t^t^pv '^'^ ^I'C 
Compjlcr to ro n them. 

There Is an otternative: If you wanl lo include tho Beagle 
CompileTS cOMI'll FW.5YSTEM filu on disks iHelL you will be ^'lling 
or giving away, you may do so after ptiyiiig a very re,JM>nable 
licensing fee lo I'he Compiler's aulhor, Alan Bird. Call or write 
for more information; 

The Software Touch 

c/o Compiler Literif^ing 

9b23 Black Mountain Road, fl204 

San Diego, Cilifornia 92126 

Or phone Tlio Soflwaro Touch: (619) 519-3U9E 
After a licensing contract has been signed and fees paid, only the 
file COMPUXK.SV^f'LM may be put on the di'^k you are selhng or 
giving away. This m the fik' that acliiLilly run^ compiUid 
programs. Under no Lircum-^tances are you pormilted to indudg 
the COMPIIKS filo on di^ks that you Sl-11 or g we_aWM. 



IS Tl IIS MANUAL UP TO DATE? 
RUN NOTES NOW TO FIND OUT. 

Run the Applesoft NOTES program on the Beagle Compiler disk 
to learn about any changes or corrections Iha^t apply lo this 
instruction manual. 



H^. - l,| 




] FOR A=eaD TD au: 

READ fl: POK^ A^S: 
N'f^XT; CALL EDO 
Z DATA ;fl5,20B,20a, 



THEBASlCFAdS 

In writing this manual, we assume you know the "basics" about 
loading and saving ftles^ running Applesoft programs atid jho on. 
Even if you don't, yuu itill should be able E<i reap mo^t ai the 
benefit;^ of the Beagle Compiler by reading pages 1-15, 

We highly recommend Apple's ejLcellent programming 
manuals, especi^iHy the Appiesoft BAS:c Pro^nimmPT's 
Reference MaTtuai and ProDP^ User's ManuaL 
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HOW TO USE 

THE BEAGLE COMPILER 



RULE#1: 

Ari'LKSOlT PROGRAMS ONLY 

The Beagle Compiler only works wilh urprotectfti proDOS-bastxl 
Appli^soft HA5IC programs. You must have a copy of tUe pm^nm 
you want compiled saved on a ProDOS disk- 
When you caliiLog A disk (by lyping CAT), "SA5" idontiRos a 
file 05 bpmg ApplPEofi basic: 



tf=Tou oin corny He BASfC pro^mmi. 
t^Voji can't compile binnfy fiie^- 
t=You Clin 'S cortipiU t£xt file&. 
tfur^f? il. 

ciififK is a prc^ram Iktt hn^ beEn 

saved in comjiiled formal, 

"COM Will read as "IM"" If the Compiler l?n [ in irLemt>ry. 



/SAMPLE, 


DISK 


NAME 


THiE 


FILE. A 


EkS 


FILE.B 


BIN 


FtLE.C 


TXT 


FILE.D 


BVS 


FILE-E 


VAP 


FILE<F 


COM 



RULE #2: 

BE SURE THE COMPILER IS INSTALLED 

The Compiler's commands won't work uniil you "install" Ihe 
Compiler in ynur Apple'^ memory. The uijsiust wav lo do ihis is 
to BOOT THE BEAGLE COMPILKR DISK (pul Ihe disk in your 
main drive and turn on your Apple). 

There arc othor way? lo inslall the Compiler thcit save 
memory and /or disk spate-sco pages If* and 27- 



RULE#3: 

WATCH OUT rOR CERTAIN THINGS 



ProtJOS's CHAIN, STORE and restore commands make 
programs require special Iroatmenl-see pa^es 18 find 19. 
Ampersand j&J sLatemenls with parameiers and the routines 
Ihai they call must be altered by someone wilh assembly 
language experionco-sce page 2Q. 

Some Applesofl commands arc not compilablc-spccifjcally 
CONT, DEL, USr, t.QAIJ, XOTKACf:, KliCALL, 5AVF, !i\ U DAP. 
TRACE and STOKf! iPTODOS 's LOA13, SAVE and STORP Ti}iU 
compile). Removing any of these commands will not harm 
99.6502% of ihe programs we have seen. 
Weird memory pokes are unpredictable. If the program you 
want lo compik poke& values into Zero Page or RAsrcsYSTEM 
or some other exotic place, go ahead and irv compilingnf 
you're lutky, you'll have no problems at all. 
Cianl Applesoft programs are usually compilable if you 
compile them to disk without the C0MPiLEK.SY5TEM file in 
memory-see page 17. 

EXPERIMENT 

WITH 

TESTl*UOGRAM 

There is a short 
Applesoft program 
called TTSTrKncRAM 
on ihe 5eagle 
Compiler disk- No 
big deal, but ji uses a 
lot of ApplCMjfl 
commands and 
serves as a guod 
demo of how the 
Compiler workb. In 
the ex El m pies on the 
\ following pages, 
^^1 almosi any 

Appli^soft program 
n miiy he substituted 
for TESTPROC.RAM, 
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HOW TO RUN AN APriESOFT PROGRAM 
AT COMPILED SPtHD 

This IS ca5V. First, be sure ihc Compiler fs insliilli-d in memory {it 
is if you have bnotcd Ihc Pciglo Compitcr di*,k). Now jvisl run 
your pntj-rjni Like yuu alw.iys do, by lyping: 

RUN NAME 
or -NAME 
(KAME is the nams-or pafkname-of i^our Applesoft progrflmj 

Aflur a brief "COWPlLt\G.-." mosMgc, your program should be 
running ,\t mjchine language ^pi?pd. il this isn'l the catc, thi? 
Compiler probably ibn'l installed. If you sec an trror m*25S£ige on 
the siireen, road pages 20-22. 

Sinto compiled progfiims have no lint? numbers, tho 
I'roUOS command HUS NAME, 8123 will not work (]23 
represents any pri.i^r,im linL: numbijr}- 

QunrriNC a program 

You C3n often quit an Applosofi program by pressing Conlral-C 
This mj^hi fiot work, hovvovor. when you're running at 
compiled speed [see page 12 for a quick fix). 

CpnlroUReael will almost always lot you quiL Somo 
programs, however, are written so you can't quit no matter 
what, and you may need to reboot to escape. 

RE-RUNNING A PROGRAM 

After you quit runnmg a compiled pro^raiti, you may type ROH 
to rerun il, IT you get a NOT A caM['lf-ED FROCK AW error message, 
something ha^ disturbed Ihe compiled program in memory. 



EXAMPLE 

To run TH5TPKOCRAM from the Beagle Compiler disk at 
compiled speed: 

1. Bool The Beagle Compiler disk, 
2- Type ROHTBSTPflOGRAM 
or typo -TESTPROGRAM 

3. To Slop the program, press Conlrol-Resel 

4. TypcRtni to run 7HSTPROGRAM again. 




HOW TO SAVE A PROGRAM ON DISK 

IN COMPILED EORMAT 

To save .i compiled version ol an Applesoft proj-ram on the 

current di'^k, ivpe: 

COMPILE NAME,NEWNAME 

(NAME is the nunic-or psthnfime-of your Applesoft pro}(riim on 
disk. NESfKAME is the rinrn^tft patknurn^for sszring the 

competed ffli-.} 

Your ApplestjfJ program will bo loaded, compiled and then 
saved on disk, A I Jt>: TYI'J-: MISMATCH error message here might 
mean ihat you used the same name for boih files. You maif uso 
the same name for the compiled file if you arc saving onto 
another disk or direclory. For eNampfc, you could tvpo: 

COMPILE /DISKl/NAME, /DISK2/NAME 
This command would load NAM]' from DISK} and save it as 
\'AME on DISK? in compili?d format. 

Cataloging the disk will reveal compiled programs as type 
COM [that's COM for COMpilcd instead of HAS fur HASic). ]f you 
catalog Without the Compiler installed, COM will appear as "INT", 



EXAMPLE 

To save TESTPROGRAM on disk in compiled format: 

1. Be ^ure ihe Compiler is installed. 

2, [nsi^Tt Iho Beagle Compiler disk in drive 1. 

3, Sot the prefix il necessary by typing PREFIX, Dl 

4. Type COMPILE TESTPHOGRAMh teste AST 

Thi?i wi)l liave a now version of Tlisfl'RtitiKAM called 
TESTiAST on the disk. When you catalog the disk tby 
typing CAT), you will see Tr.ST]:A*iT listed as a lOm file. 



WHY SAVE [N COMPILED FORMAT7 

• You save time by not having to wait for compiling each time 
you run the program. 

■ You save disk space because compiled files are generally 
sniafler than Applesoft files, 

■ You save memory space because the COMPII UAi file (see page 
26) doesn't need to be in memory when you run the program. 

■ Your programs aren't listable and snoopers can'l look ai them 
and change lhi;m. (Thjs can be a ifsad vantage). 
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HOW TO RUN A COMl'lLHD PROGRAM 

FROM DISK 



You run a compiled (COM) file from disk the same way you run 
an Applesoft tBAS) file. Typo: 

RUK MAM£ 
or -NAME 
iNAME i$ the name-or pathfame-of your comj/iled program.) 



EXAMPLE 

To run TESTPROGRAM in compiled format; 

1, Compile Tf:STPKOCKAM bo il crcatG? ihp COM file TJISTFA5T 
(follow the steps in the previous example). 

2. Typo RUNTZSTrAST or -TBST7AST 



The C[JMniLER.5YSTI M file mui^l tie instjllod to run compiled 
programs (it is if you boiJied the Beagle Compiler disk). You can 
savo memory by not Installing the COMl'ILF-R /i!e-sfe page 27. 
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HOW TO MAKE A CHANGE 
TO A COMPILED PROGRAM 

You can't change a eompilcd program, in^tcjd, chango the 
Applesoft "source" program (ihc one you compiled in the first 
place). Make changes the way you always do, and always be sure 
to sa\'c Lho chln^;cH^ program to disk boforu rcvompiiing. 

J?cad the nole about program editors C.V.I A', and I'KOGkAM 
WklTJiE^ on p.ige n, 



EXAMPLE 

To make a change !o Tr?T[*ROCRAM: 

1. Type LOADTESTPROGRAM 

2. Type list lO to see program lint 10, 

3. Type 10 X=5 to change line 10, Thi!^ will have the effect 
of changing the pallums on the screen when the program 
15 ^unnin,^. 

4. Type SAVE TKaT2 to save lho Applesoft change, 
(Any lepal file name may be used,) 

5. With the Compiler installed, type BON TEST2 or 
-TEST2 to run at compiled speed. 

Or typo COMPILE TEST2, NEWTESTa to savo in compiled 
formal- 

6. To make more changos typo LOAD test? and go bjck to 
5lcp 2. 



^4 



13 



HOW TO MAKE CONTROL-C 
STOP A COMPILED PROGRAM 

Nonnolly Control-C Will stop an Applesoft program but haw no 
efft.'ct on (;ompil(?d programs (encepl in rcspanw lo tM'UT 
siateircnls). To make ConTroI-C halt a compilud prugfjiTiH add a 
RESUME statement BomcwhoR? in ihc progrnm you aro S"'^E '° 
compilo. Think twice before using this technique, bocauso it will 
havf? ihc side effect of making your compiled program run 
so mi? what Eilower, 

Tht RHSUMK statement ha^ an undesirable effect on 
Applesoft programs, so you should put it somewhere where it 
can't possibly get exccuted-likc alter the end of vour proj^ram 
Iend: kKUMli). 



EXAMPLE 

To allow TUSTPROGRAM to be hailed wilh Control-C after it is 
compiled: 

1. Type LOADTfiSTPHOCaAM 

2. Type 60000 ESD: resume iti add program line fiOOOO. 
{60UO0 may be replaced with any lire iiumbcr 1-63999; just 
be sure the RLSUME slalement duesn'l get executed.) 

3. Type SAVE TESTC la save the changed version, 
(Any legal file name may be used,) 

4. Type -TESTC to run the program, 

5. Press Conliol-C to stop the prt^gram. 



A NEW ?BREAK MESSAGE 

When vour compiled program is slopped by Conirol-C (or a 5TOI' 
statemenl or an error), you will see an error mes'^age someihing 
like ?aREAK AT SOABC. Thi> tells you the hexadecimal address in 
memory where the program slopped (instead ot which Ihie 
number, because there are no line numbers in compiled 
programs). See page 2^ for more informaiion about this number. 



HOW TO RUN A PROGftAM 
AT NORMAL SPEED 

The best way lo run a projjram at normal speed is to remove the 
Compiler from memory by booting a normal ProDOS disk. 

Thf msrhivi described beioTH is jiol guoranleed to work. In fact, 
iL'ilh cerinJii prcgrams, li could tsuse serious problems that 
require you to reboot. 

At'coays SAVE YOUR PROGRAMS before rurtning them! 

After taking the warning above into consideration, load an 
Applesoft program from di?k and type :RnH. Notice thai ihis 
command begins wjlh a colon (:), If you omit the colon you'll 

get a ^OT A COMPJ[.i:D riiO<;iO\W error message. 



EXAMPLE 

To run TESTFROGRAM at normal speed with the Compiler 

installed: 

0. Ke^id ihe Warning above 

1 Type LOAC TESTPROGRAM 

2. Type :ROH 

3. To quit, press Control-C or Control-Reset 

4. To see it a^ain^ type iRXTH again 




X 
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HOW TO SrECU-V A NEW ADDRESS 
FORAl'ROGRAM 

(lor ,idvjiut'J pro|;rjnimiT!>) 

Compilt^d pni^rams normallv load and run ^t addri'ss 2<M9 
(SCWl), just like- Applesoft pnig^inr:. Vou mjy run a nompilud 
program at a ditforent address by n^hanging ihc Applosoft 
program beiorc it is tomp:lcdr 

For e?<ampli?. ir^^cTt the rollowing linf ai ihe be^ifining of 
Tf^STPROGJiAM to run JL above hi-rcs page ] at 163H4 t&40[)0); 

i IF" PZEV.ilQAi^^^i THEN POKE 163&"^,0: POKE 
\QA.f,/i: PRINT CKRSM) "P.U?^ rLST:'30C-PAM" 

RcplanG tht^ &4's wiih 9S's and thp lh3S^ lAith 24576 la load the 
program abovG hi-res pagi? 2 at 2457fi (SfiOOO), 

You mav alw specify an address wilh a KUX command 
followed by tt commii and tbe addreiis. The foUowinj; command 
will compile and run an Applciof! priigr,Tm-or run a compilod 
program-above p.igL* 1 and pago 2 rc^pocUvcly: 

RON NAME, A$4D00 
RUN NAME, A$€DOO 

iNoto: In Ihi^ procciiurL', "RUN" cannot bo ropldced with a 
hyphcnj 
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HOW TO WRITE PROGRAMS 

FOR MAXIMUM COMPILED SPEED 

tlor ddvancL'd progr.immors^ 

Thu ono major point lo keep in mind lo make compiled 
programs run taster j^ avoid using floaimg point values 
whenirvor possible. The Compiler docs all of Us math using 
integer valuos whenever it can-inlegers process much faster 
than floating point values, 

Roating point is used: 

• whi^n a value has a fractional part (j,e. 35). 

• when a value is greater than 32767 or less than -32767. 

• when division is used in an expression. 

■ when any of the following functions are used: 
ATX. CDS. VJiP. LOG, RNT), 5IN, 5QK Or TAN 

BASIC TECHNIQUES DONT APPLY 

The i^ullowtng programming iriethods i2Q speed up Applesoft 
programs but they DC \pT speed up compiled programs [they 
also don'j do any harm), 

• Using Tfal variables instead of integer variables. 
(Using A^=3 instead of A=3 will not affect a compiled 
program's speed.) 

■ Using variables instead of numeric constants, 

(In a compiled program, A=PJ executes no faster than A=3 H159J 

• Putting frequenlly-etjecuied hnes and subroutines near the 
beginning of a program. 

• Putting frequently -used variables near the beginning of a 
program. 
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HOW TO COMriLE PROGRAMS THAT USE 
THE CHAIN COMMAND 

The PruDOS CHAIM command works just like the I'roDOS KUN 
command, bill fni'^Iing variables sl.iy intoch 

Trcgrams thai use CHAIN !^han? irommon v»\riable5 and 
mu^t be given special Iroatmerl for compiling to be successful. 
Otherwise a lit r. type: MlSMATcitprror will occur. 

All programs involved with a CHAIN command must be 
compiled fo disk using Ihe COMPlLt command to compile one 
program and a special COMMGM command lo ojmpile the other 
programts), COMMON'S syntax i5 simlar to COMI'lLHi 

COMMON NAME, NEWNAME 

COMMON inuiil be u^ed intmeUiuit^ly after COMPILI'.- It you laier 
make a program change or add a new file thai will aiAl.N to or 
fTom the exislmg (already compiled) files, you musl sUft ovgt 
and recompile tiU of the filci^. 



EXAMPLE 

Say you have ihree programs- MAIN -FROG. rKOG.A and 
FR OC^B- lhat share variable?. MAIN-PROG is the siariup 
program and U will cjlAlN lo PROCA which will CHAIN to 
PROG.l which will C\ iAlN back to MAINJ'WOC, Hero s whal 
you do to compile these programs: 

1 Compile MAlNJ'E^CX: wilh the usual COMPlLn command' 
COHPILfi MAIN. PROG, MAIN. COMP 
(Any legal file name may bo used.) 

2. ImmediaLelv compile each program that is lo share dota 
by using the COMMON command. 
COMI^ON PaOG.A,PROG.A.COHP 
COMMON PBOG. B, PROG,B . COHP 

3r To run the program(s) Wilh the Compiler installed, type; 
RDH MAIH - COMP 
or -MAltl.COMP 

(Noll?: Even the coMMo\od Files may bi? run.) 
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IIOWTO COMPILE PH0GKAM5 THAT USE 
STORE AND RESTORE COMMANDS 

Nnfr'; T/jjH pa^e ajrj'lie^ lo the FroDO^srOKi and RESTOfiK 
Communds. The Appiesofl ULilOKF. cammund mil vampile ^i^t 
fine. The Applesoft sTOiiT. comnmnd is obsotnle. 

The ProD055TORE command normally saveji the variables in 
memory on disk in a VAK file. RESTORE loads these variables 
back into memory. 

Programs ihai use ^TtiRE ,ind RIISTOKF share common 
variables and must be j^iven special trt-alment lor compiling to 
bo suctessfuL The programs ihlisI be compiled lo disk using the 
COMPILE command on one program and the COMMON commflnd 
on the other [set* CHAIN, previous page), 

CoMMOx muM be used imm.'iiiiiii-ty after COMPII V. Ef you 
bttT make a program change or add a new file Ihal shares 
variables with ihe e?(isting [already compiled} file*, vou must 
Stan over and recompile all of the tiles. 

Stoke and restore in compiled programs create and use 
variable files of lype CVH instead of VAR. 



EXAMPLE 

Say you have a program called DATA5ETUP that uses the 
STORI^ command lo write variables that will be loaded 
(using RESTORE) by a program tallod DIG.GAME. Here;- what 

you do lo compile these two progTanis: 

1. Type COMPILE BIG. GAME, BIG. GAME . COMP 

(Any legal file name may be u^ed.) 
2- Imme diately Lvpc 

COMMON DATA -SETUP. DATA. SETUP. CDMP 
3, To run eilher program wiih ihe Compiler installed, lype: 

RON BIG. GAME. COMP or -DATA. SETUP .COMP 
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HOW TO WRITE AMl'ERSANU ROUTINES 
FOR COMPILED PROGRAMS 

(Fit iidvjiicud iis".embiy langu-tgt: pnJgMmmcrs only, J 

An ampersand routine* without parameters (ft by itt;dn will 
compile jutit fini?. Ampcrsiind ri>uli[>i?Ei with paramulLTs (like 
&XXX or &XXX>Tfy:£/Z] are a diflcnml ^tory, Goih ihe ampersand 
command and Ihi? machine l.ingujge rauline itself muat be 
modi tied . 

CHANGE #J: 

USE && INSTEAD OF fi^ 

When calling .in ampersind routine from a compiled program, 

you mu!it use ivvo consoculive ampersands (for cx^imple, you 

would use tSfSORT inslead of &SORT). This is how Ihc Compiler 

dclecis programs that have or have not been mtidified. 

CHANCE #2j 

RE-EVALUATE YOUR PARAMETERS 

Wilh Ihe Compiler instjUed, a fSR la S98fD will evaluate ihe 

next parameter after an ampersand: 

• lF_the parameter i^ n string, a pointer to the strmg will be 
found at $¥h,S^7. All strings in a compiled program are stored 
with the length in the first byte. 

■ IF the pJrameier is a numeric value and the carry flag 15 ctsar^ 
the value is an mtcger wilh its low byle in the X-rcgister and 
the high byte in the Accumulalor. 

• If the parameter is a numeric value and the Cijrry flag is st-t. 
the value is floating point and stored in the FAC {at S9DJ. 

There is no way (or the Compiler to determine if the correct 
parameters are being passed to your ampersand rouhnes. It the 
correct parameters are not there, the program will nuist likeJy 
crash miserably. 



/ 
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EX&MPLE 

Let's write an ampersand routine that prints the first character in 

String SS, N linn-s. Our Applesoft progr*im look> like thls. 

This program's mission is to print SG C's. The assembly code 
would look like this; 



SCS 

CMP 
aN£ 
TXA 
PHA 
JSR 
PLA 
TAX 
SEQ 
LDT 
IDA 
B£0 

L3A 

QP.A 

LOOP JEfi 

DEX 

BNE 
DONE HTS 
ERROR LDX 

JMP 



S9aFD ;tvaiute N 

ERROR /reject floating pC. values 

10 ;evdluate high-byte 

ERROR yricn't accept anyr.hlng>256 

; save N 
59BFD ;evaiiitLB SS 

; restore N 
iuse as counter 

;c3iinter was 

),V I'get length oi gt-lng 
;tiu!I string 



done: 

#0 
{BhB 

DUNK 



(SF6],Y .-qet 1st character in string 

#58D .-set MSB 

SfDED ;pr]nt character 

LOOP ; loop 

; return to CQTnpi Lei 
#53 -'"TLLEGAL QUANTETV t^RROR" 

S9BF1 ;iiandiG error 
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COMriLED PROGRAM 
EXECUTION ERRORS 

An Applesoft or ProEVOS prngram error vdW aiusc a co[npilk:d 
program to cm?^h jiisl like an iinoJmpilcd program. The only 
difference is ihat C(jmpili?d prograni!! produce strange error 
mesMges like; 

?ILlJiGA;. QUAVnTY ERROK AT ?QAHC . 
Uncompilcd program^ as yau know, produce messages Uke: 

?H.LK<:;AI. QUANTTTy LKliOR 1\ 123 . 
[n this comparison, 5CIAFC Is the hexEidt'cimal hoition (addross) 
in memory of Ihe error, and 123 l'^ the iin^ number of thu error 
(compiled programs have na line numbers). 

Since line numbers are ea-^ier to work with Ihan memory 
locations, the mosl efficieni way lo trap terrors is lo lest ynur 
programs and get them worki t u; curreclly bctorc you compile . 

THE FRINT^LINES PROGRAM 

CONVERTS SADDRESSES TO IJNE NUMBtUS 

(For advanced progr(immers} 

If you in^lsl on ignoring our advice above: To determine the 
line number thiit h et^uivalent lo a hei error addre?^, compile a 
program using the COMPILE or HUN' command, [hen; 

E (optional) Turn on your prinli.T by lyping PR$1. 

2. Wilh the Beagle Compilur di^k in Ihc current drive, type: 
BRUNPRIWT- LINES or -PRIHT. LINES 

3, type PR#0 lo doaclivaie your printer il necessary. 

Tbe numbers produced by the l^KINTJ.lNHS program are the 
staTtiti^ hox addresses and matching decimal line numbers. 
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ERRORS FOUND 
DURING COMPILING 

If your Appk^soft program conliiins Errors, the Compiler will do 
it5 lyvel best Ui find lliucn during Ihi? compiling pnitvjns. Each 
offirdtng iiinz will bt! liBtod wiih the cipprusimiito loc^ition 
marked. Thf Compiler will then ask "COiVTiN'UE Wmi VRKOKS?" 
to SLV if yULi vViint to jjo ahesd jnd run thi' program anyway 
(sonic "tirror?;" arc inlcntianal or cjuif nu probltrnj. It you 
answer iw. compiling will ^lop so you can miikc repairs, Save 
your repaired program on diek; [hen recompile ic. 

Many errors will noi be found by the Cumpiler-thls 
iTK'hides mo^l Proi:)05 errors and error:i inside quote miirks. Hero 
are some common errors that will be found during compiling: 

<7> (SYNTAX ERROR) 

■ A <?> ^.ymbol toiild mean your prcigrnm cunt.iins an Applesoft 
keyword that Is unacceptable to the Compiler- specifically 
CO\T, DEL, LIST, LOAD, NGTRACE. KHCALJ., SAVK, 51 II.OAD. STORE 
and TRAC[[. Programs with these commands will not compile, 
(Nolu: i'ri'lJOS :; LOAD, SaVH and STORE wili compile), 

■ Other culprits arc those yau have encountered before, such SiS 
missing parameters (Like III'LOT with no ceordinjli:^), type 
mismatches (like AS=3), misspelled keywords (like PIR\T). 
missing commas and colons, and so on. Your Applesoft 
instruction manuals will help you moke progrum repairs. 

<fl> lUNDEFlNED LINH NUMBER ERROK) 

A <:#> symbol usually means yuur program used a GOTO or 

£;05UB to a noni?vi«ent line numt>or. 

<A> [ARRAY DIMENSION ERROR) 

An <A;' means your program h.is illegally allocated arriiys. For 

eKampIn: Af25)=3: A(6;3)=3 j 

< *> 1ILLECAL QUANTITY ERRORl ' 

The only illegal quantities Iho Compiler will find ari; illegal 
addresses tfor e\ample, POKJi 9DQ0(»,u), Other illegal quantities iliko 
JIPLDT woooofl) won'i be roLlctid until your program crashes, 

INCLUDE APPENDED MACHINE CODE? 

This messaj^e means the Compiler has lound some extra space at 
the t:nd ot your program. This could be uselepis g;irbago or it 
could be valuable datni or a routine that h called by the prognim. 
When unjiure, play it safe by answt-nng Y [Yes. include Iho code), 
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KHYEOARD 
ERRORS 



These errors may occur immedialuly aftor you type a command: 

FILE TVI'E MISMATCH 

• Maybe vou used the same two names when compiling a file to 
disk (COMPILE KAHE.NAME]- 

■ Or you used a command liko compile KaMe, HEwnrme and 
\t'W\AMJi wjs already on ihe d isle as a Ivpt'oiher ihan CiiM. 

■ Or you ran a program thai uses alAI\', ^roKK or KJISTORE and 
you didn't compile with the COMMON' command {page lM-19), 

• Or you wrote an Applesoft (UA5) STAKTUP program. 5TAKTUP 
must be a compiled iCQM) filo- 

NO BUFFERS AVAILABLE 

■ You may have tried lo mslall the the COM PI 1. 1; R, SYSTEM or 
COMPILER file more than once. One lime is enough. 

■ Or vou may have tried to nm a program below address SGfiOl. 

■ Or you may have pressed Control-Reset during a catalog. 
Solution: Try again or reboot. 

NOT A COMPILED PROGRAM 

With the Compiler in memory, you typed RON after loading an 

Applesoft program- See pages 10 and 15, 

PATH NOT FOUND 

Translation, file Not Found. If you're sure the not-found file is 
on the dii^k iind you spelled its name right, try typing PREFIX/ 
or PREFIX, S6, Dl (u^e your slot and drive numbers) or 
PREFIX/ DIH/ SUB (use your directory/subdirectory naines), 

FROGRAM TOO LARGE 

■ Your Apple'^ft program is too largu to iit En memory. 

• Or you are trying to run a program at ^o^] high an address. 

Try compiling to disk^ then removmg the COMPILER file {page 37). 

7SYNTAX ERROR 

• Maybe you spelled a command wrong, 

■ Or maybe you used the COMPILE or COMMON command 

without idi^talling the Compiler. 

■ If you get a ?SV.\T.\X EKRQR as a response to typing something 
you know ts legal (like "LIST"), memory is probably damaged, 
and vou should reboot. Try pressing Control-Reset first. (It 
miglit not help, but it feels kind of good.) 
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COMPILER AND 
COMFILER^SYSTEM 

WhfR you catalog ibe Bcdgic Compiler di^k, vou will see the iwo 
Files COMI'll FK (EilN) ilTid COMPILER.5YSTEM (SV^) li^lcd. 

^ COMPILER is ihe progrEim that cgnvprts Applesoft programs 
inio toinpiltd format, 

^ COMPILER. SYSTEM is the program IhalruH^^progTams that 
hiivo iilroady been compilod. 

When you bool the Beagle Compiler disk, here's what happens; 
1- COMiMLRK,SV£TE;M is insiallcd inlo memory. 

2. Startup is loEidcd and run. 

3. COMri[ FR is iriFitallpd in memory. 

If no COM file namt^d STARTLTI' exists nn Ihc disk, ihe above 
process Slops .iftor slop 1 . Pcaglc Compiler's STARTTJ]' loads 
COMPfLfR, all hough you may change thai if you like by replacing 
STARTUP wilh your own version, STARTUP mu^l be a COM file. 
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OMIT COMPILER 
TO SAVE SPACE 

[r you arc only going to bo running compiled [COM) pWgrams 
and noi converling Applesoft (HA^) programs, you can conserve 
:ibout 6K of memory bv not msiallmg the COMPILER trlEi Any one 
ol Ihc5c mL'ihods will do iho trifk: 

• Rename the STARTUP file on ihu Boaglo Compiler disk before 
b()oiing. Then b^xji the disk- 

• Or. replace Gcagk' Compiler's STARTUP With yavr own version 
thiit doesn'l install COMPILEK. STARTUP musi be a COM fllo . 

■ Or, copy the COMI'll hMfeYStrM file onto another disk that 
conlains Ihe file PHODOB fbul not COMPII KK or HA^ICSYBTEM). 
PcTOl this disk and vou will be able? fo run compiled programs, 
bul ncil convert ApplL'solt programs. 



OMIT COMPILER.SYSTEM 

TO COMPILE LARGE PROGRAMS 

If you are going lo compile a very large Applesoft program, there 
nijy not bo room in memory ior vour program and both Beagle 
Compiler files. A solution might be lo install Ihe COMPIl V.K file 
Without COMPILER.SVSTEM. then compile your Applesoft 
program to disk. 

To prevent COMPIL12R.SY&TFM from kudingH bool a normal 
ProDOS disk Ihnt kxids liA5[c,sVbTi;M, then inscri Ihe Beagle 
Compiler disk and type the comm.ind BROS compileh [t>r 
-COMPILER). Do this only onco because comi'Ii I ke.itshKof 
memory each time its insiaUed. 

Remember, COMPILER. 5 YSTKM Will have lo bo installed 
ULone or Wiih COMr][.FR) lo aciually r:ii\ compiled pr-igram^. 
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MENU 

Menu Is a com file that lets you select disk drives and programfi 
from an ApplfWork^-sIyle menu. Vau can makL' MILMJ run 
when you bool a disk by renaming il STARTUl'. Or you c^n make 
youT STAKTUr program run \tE\U. 

To get MEMJ going, type "MEND. A list oi all of ihe Liviiilflble 
PraDOS drives will appear al the top of ihe scrtfn, "S6,D1" 
means SIol-G Drive-!, "S6^D2" means Slol^ Drive- 3, etc. 
S3,D2 represents TroDOS's RAM disk. Below thai will be all o( the 
executable files (BAS, BINand COM) on the highLighlod drive. 

Do ihis to run a program from one of your drives: 

1. Press the "< >" keys or r number to highlight the drive 
number [hat contains Ihc program you would like to run4 
That drive's file names will be displayed on the scroen. 

2. Press the ARROW keys and/or the TAB key tD highlight the 
program vou would like to run. 

3. Priras the RETURN key to run the highlighted program. 
If a subdirectory is highlighted when you press RETURN, 
its file names will bo displaycd-go back to step 2. 

To quit MENU at any time, press the ESC key. 



MENU ERROR MESSAGES 

• 1/0 ERROR might mean a drive door is open. 

• NO DEVICE ERROR usually means you are trying lo read a 
slot's drive 2 when no drive 2 exists. 

■ PATti NOT FOUND probably means you switched disks, 

OTHER POSSIBLE PROBLEMS 

■ If a program crashes, it probably wasn't written to be run (for 
example, it mi^hl be a hi-res picture instead of a program), 

• If you don^l see a program listed an the sereen and you know 
il'b on the disk, it might be a non-excctjlablo (ile type like TXT 
or VAR. Or there might not be room for it on the screenr The 
limit in BO-columns is 60 file names/10 disk drives. In 40- 
columns the limit is 3D file names/5 drives. 



29 



ENHANCEMENTS 

TO COMPMLLRSYSTEM 

The programs on this page make patches tu Ihe Compiler. 
Just BRUN the file after booting the Beagle Compiler disk 
(COMI'ILLR.SV5TILM mu^l alrejdy be in memory). 



INPUT.ANYTH1NG 

This patch replaces the Compilers LM^UT statement with one 
that allows commjs and colons. This is very handy when 
inpuiling data from text files. 



SLOW.PHL 

InstalUng BLOWTDL puts a ^mall delay in Ihe TDL (paddle) 
function so you will always get the correct reading. 

The Applesoft BASIC Programmer's Rtfifence Manual 
recommends that if you are doing consecutive reads of the game 
paddle or joystick vvith the PDL function, that you put a small 
loop in bet ween the reads such as EORX = ITO lO: [^EXT. Because 
the Compiler causes programs to run much faster, yciu will have 
to increase these delays. Or utilize SLOW.PDL 



FAST,HFLOT 

Fabt.MPLOT replaces the III-LOT slfltemonl with one that is much 
faster. It's not normally installed in the Compiler because it takes 
up a considerable amount of memory, Don't u^c this patch 
unless your programs are heavily into hi-res plutting, ^ * 



WOUID YOU 
JU5lHGRtr 



1 CALL'3103: POKh. 

230,32: Cf.Li.-3U8€: 
HCOLOPl-y: HPLOT 
9,5; DNERR GOTO 1 

2 HPLOT TO iiNQ(U'2B0 
V fiATO/JJ-^OO: RU,V 2 



, 
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APPLESOFT/PRODOS 
COMMAND SUMMARY 

LI.se ihi^ list fur n^forcncc. For mure complfit? iiif(»rmalion, check 
Ihe nearest Applesoft or ProDOS in&truclion manual. 



A Applesoft 

P J'roDOS 

* Dejgle Compiler 



f fik'/pJlhnamL' 
AS siring 
X variable 



ni,n,i,| 



in[<.'^urs 
real numbers 



ABS^xJ 

AND 

APPiiND i 

ASCr'A'^) 

ASC(A$) 

AT 

ATM 

BLOAD f 

BRUN f 

BSAVE f,Aii,Lm 

CALLn 

CAT 

CATALOG 

CHAIN f 

CHRSCn) 

CLHAR 

CLOSFf 

COLOK^n 

COMMON iU2 

COMPILE iXil 

CONT 

COS(x} 

CREATE F 

DATA AS,v,yp2 

DEF FN MX)=Hx> 

DEL n,m 

DELETE f 

DlMX{n) 

DIMA$(n) 

DRAW n AT i,j 

END 

EXECf 

EXP(x) 



Absolute (posilive) value: of \ 

Logical "and " in an IF ^Inlcment 

Add daui Ifi ii ^^oqurnlial lexi file 

ASCFJ value of a char^cirr 

A5C11 value of a slring's first character 

Sec nKAW, XDR^\W. J fJ.l\ and VL]\ 

Arciatigonl of v in radiLins 

Lnad binary file f 

Load and oxoculc binary program f 

Save dma; Addresii n, Ungih m 

Branch lo machine language routine at n 

Display disk conicnis in ■JO columns 

Display di^k conli^nts in 80 columns 

Run hlo f ^vlthout clearing Viiriables 

Character who&c ASCII value is n 

Clesr all variables 

Stop reading or writing a text MIo 

5ct lores color lo n (0-15) 

Compile a share- variables file tQ disk 

Load fl (BAS)h compile and save as f2ECOM) 

Ccnlinue a program 

Cosine of x in radians 

Create a subdireclorv file 

Strings and values (o b^ read 

Define a function 

Detele program lines n through m 

Delete file f from disk 

Dimension a numerical array 

Dimension a siring array 

Draw a hi-res shape n at i,j 

Stop a program with no message 

Execute text file I from the keyboard 

c {1718289) to ihe \lh power ' 
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A 
A 

A 
A 
A 
A 
A 
A 
A 
A 
A 
A 
A 
A 
A 
A 
A 
A 
A 
A 
A 
A 
A 
A 
A 
A 
A 
A 
A 
A 
A 



FTASH 

FLDSH 

FN 

FOR X=n TO m 

FRE 

FBE(O) 

GETLAS 

CETX 

GOSUB n 

GOTO n 

GR 

HCOLOR^n 

HGR 

1-IGR2 

HIMEM: n 

HLIN n,m AT j 

HOME 

HPLOTij 

HELOT ij TO n,m 

HTAB n 

IF...THEN-. 

INffn 

INPUT X 

INPUT "ABC";AS 

INT(KNDn>+n) 

INVERSE 

LEFTSlAS.n) 

LEN(ASI 

LFTX=^Y 

UST 

LiST-n 

LIST n- 

LIST n-m 

LOAD 

LOAD f 

LOCKf 

LOG(x) 

LOMEM: n 

MlDS(AS,n,m) 



Sol flashing j^reen output t40-co]umns) 

Wriie buffer to disk without closing tile 

See DEF FN 

Let X=nH X=n-i-l... until X=m 

Free all available memory 

Amount uf Eree memory available 

Wait for one-chariKter user input 

Wait for one-number user input 

Branch to subruutine at line n 

Branch to line n 

View and clear lo-rcs page 1 

Set hi-rcs color to n (0-7) 

View and clear upper hi-res page 1 

View and clear full hi-res page 2 

Set highest memory address available 

Draw a horizontal lures line 

Clear text screen lo black 

Plot a hires point 

Draw a hj-res line 

Posiiion cursor at hori7onlal position n 

Logical "if true, "then" execute 

Take input from slot n 

(or AS) Wait for user input 

(or X) Prmt "ADC " and wait for input 

Randum inieger to n-1 

Set black-on-whito text output 

Rrsl n characters of a string 

Number of characters in a string 

Set X e<]ual lo Y [LET is optional) 

List a program from the beginning 

List lo tine n 

List from line n 

(or nnm) Litl lines n through m 

Load a program From tape (obsolete) 

Load a file from disk 

Protect a disk file from alteration 

Natural logarithm of x 

Sel slart-of-variabtes location 

m characters of A5. starling at n 
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COMMAND SIJAMMNY (continitefH 



A 


NI'W 


A 


NLXT X 


A 


NORMAL 


A 


NOT 


A 


NO I RACE 


A 


ONXCOSUBr.m 


A 


Oj\XCOTOn,m,. 


A 


ONrUllCOlOn 


P 


OPLN ( 


A 


Ok 


A 


l*DUn) 


A 


I'tiEKCn) 


A 


PLOTlj 


A 


i'OKE n,m 


A 


POP 


A 


I'OSfO) 


P 


posmoMf 


A P 


PRtfn 


1^ 


putnx f 


P 


PREFIX/ 


A 


PRINT 


A 


PRINT "ABC" 


A 


PKINTX 


A 


READ AS 


P 


READ f 


A 


RECALL X 


A 


nvM 


P 


[ttNAMEfl.rz 


A 


RESTORE 


P 


RESTORE f 


A 


RESUME 


A 


RETURN 


A 


RICnTS(A$,n> 


A 


RND(01 


A 


RNDd) 


A 


ROT=ii 


A 


RUN 


A 


RUN 11 


1' 


RUN f 


* 


RUN i 



DelvU- Liurrijni prtigr,im frtim mtTnory 

Di'finf the t'nd ai ,i Ilsk-X] XT Uuip 

Si?t rormiil whilu-im-bliick text oulput 

Logical "iiol" m an l[ t^l^itcmfnl 

Cancel TliACi' 

GOSUB Xth lint' numbLT 

Branch 111 Xth Iii\l' number 

Jiranth to linu n if ^ii crrnr ufcurs 

BL^^in KI.AI)crVVKnUi-iK3 toxt flic 

Logical "or" in an [r stiitomonl 

Valuu (0-255) of paddle n 10-3) 

Memory v.ilue at locjtittn n 

Plot a lo-rci doi 

Sot lucjtjnn n w vliIuc m 

Cancel mohX rocent COSUli 

Hori;^oniEit cursor positmn 

LocaiD Rij\(J or write: in a file 

Sond output to slut n 

Change defjuU direciory 

Cancel current prefix 

Skip a text line 

Print characters wilhin quotes 

Prmt value of variable X 

(or Xj Read a DATA string or value 

Iniliflte reading a ditik le>t |i]e 

Rolrieve array frutii tape (obsalete) 

Programmer's remark follows 

]<L'name a file on djsk 

Reiel pointer to Hrst DATA statemont 

Retneve strings and variables from file f 

Continue program where orrur i^ccurrcd 

Branch back lo statement iiflcr GOSUH 

LaM n characters of a string 

Repeat last random number 

Random number (" tu 0.99yyyy999j 

Sl'I rotation o/ a shape to n <n-fi4j 

Eieciite a program friim beginning 

Execute a program from line n 

Load and L'xocule a program fium disk 

Lo^di compile 4t execute a program from disk 
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A 




SAVE 


A 




SAVEf 


A 




SCALE=n 


A 




SCRNIiJ) 


A 




SGNIXI 


A 




SftLOAD 


A 




SINlxl 


A 




SPQnl 


A 




SPEtD=n 


A 




5QR(^) 


A 




STEPn 


A 




STOP 




P 


STORE f 


A 




STORE X 


A 




STRSlx) 


A 




TAB(nJ 


A 




TANIXJ 


A 




TEXT 


A 




THEN 


A 




TO 


A 




TRACE 




P 


UNLOCK f 


A 




USRixJ 


A 




VAL(AS) 




P 


VF.RIEY f 


A 




VEIN n,m XV i 


A 




VTAB n 


A 




WAIT i,i,k 




P 


WRITE f 


A 




XDRAW n AT i.j 


A 




XPLOT 


A 


F 


-f 
? 



Save a program to tape (obsolete) 

Save a program i to di^k 

Set y:ak" [or DKAW or XDKAW fU'255) 

Lo-rcs screen culor at point i,j 

SiRnofXf+l.-l utO) 

Load sh(ipe table iTOm tape (obsolete) 

Sme ol X m radian'^ 

n spao^ in a TKINT statement 

Char^icler output rjte (0-253) 

Square root of x 

Increment-sixe in a FOK-XEXT loop 

Stop proj^ram and print line number 

Store current variijbles as VAK file ( 

Store an array on tape (obsolete) 

String etjuivalent of value x 

Position the cursor in a l'K[>JT statemcni 

Tangent of if in radians 

Switch to leit mode; cancel windows 

Logical "then" m an II- statement 

See row and ]iPLar 

Print line numbers as executed 

Cancel LOCK 

Pass X to 3 miichine subroutine 

Numeric value of a string 

Verify thiU file f is on the di^k 

Draw a vertical lo-rcs line 

Move the cursor to text line n 

Insert a condilioiial pause 

Initiate writing to a disk ic\t file 

Draw in the opposite color 

tUnused Applesoft reserved word) 

Execute file f 

Same as FKIXT 
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MODIFYING APPLESOFT 
VIA THE BEAGLE COMPILER 

Actujjlly, WL'TL' not goinR lo [c]| you mui:k on thi? next fi?w pogcs, 
bui vvo do want to give ^11 thu h^ickcrs, snooptrrs and other nice 
pGopjG mil there a t'lsU of how the Cumpilpr worl<;s. Pk\nso 
amsidL^r thi^ infurmatiun a^ a Erecbie only-don'i call Bizagic Bras 
for help in analyzing the Compiler's functions. 

HAVE FUN IMPROVING 

lOR RUINING) APPLESOFT! 

PrugTEimmors havo always had a desire to modify Che Applesoft 

interpreter to add more power and ffficioncy tu a aomewhal stale 

lan^juage. Sinte (he interpreter is in ROM, il b a bit dilheult to 

patch. The Beagle Compiler's inlerpreter, however, is in RAM, 

and you car. change itaiements arid funeiions at will. 

The Jump Table ^t^rting on the next piige goei^ from S990Q lo 
sy9FF and contains veetors laddressc.s) lo each part of the 
Compiler that processes statements and functions. A few well- 
placed pokes from BASIC or machine langtiago v^ill "steer" 
comnands to any area of memory you choose. 

For example, the following program, when compiled, will 
make home aet like ugh. From there, you're on your own. 

10 POKE 35206, PEEK(39?8Z)r REM 599^9, 5997^ 

2Q POKE 39205, PLEX (39263): HEM S99Z9,S9573 

21 : HEM S992a-3S IS THE ADDPlb£ fOB HOME 

2? : REM ^SgT.'J-TS IS THE ATJDRESS FOB HGP 

30 HOME: P=:M UCMF- NOW WDRSS LIT^E HGR 

^0 f1i:0r,GP=^: HPLO: 0,0 70 ?79, I ^I 

Warning- Programs like the one above can quickly open up a 
whole oan i)f loormSl 
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THE BEAGLE COMPILLR 
JUMP TABLE 



M^re^ Safnt 



rijrtcnDn 




S9^00 


inii 


IniLull^p dud run Ihc pri>grjm '"^ 


59902 


fxin 


kU\ liiK'numbcr 1 


S99M 


cLi^ar 


CIJ'AH 


59Wfi 


r»lor<? 


KE^nWlL 


S99(» 


un 


0\ t^OTO/COBUB 


E9WA 


^li> 


CDTO 


S990C 


Kiftib 


GOSUB 


S9*J0E 


lUlurn 


KETURX 


SWIO 


r*P 


|\JJ' 


5i«l2 


uruil 


E\[3 [hhill5 pnigrjmj 


£!49H 


kt 


^5lgn VhiIiH' 1(1 f.(inplo numeric variable 


59916 


for 


FOK (^01 TO vjJEic and inilnliJ*.' Iwtp) 


EM1« 


^tcp 


5TI:I' 


S991A 


numpn 


QViiiiiale and pnnt a numcrk value 


swic 


*trprT 


cvalujti^ and prini a string VhiIu9 


5991 E 


spc 


Sl'C 


S992D 


tab 


TAFl 


S0922 


(umm^i 


cLin>ETLCi funi^lkan In PRLVT sliiEi'mciit 


S9924 


croul 


prml i KLHURN 


S9936 


[TAl 


riLXT 


S997S 


homo 


nOME 


S992A 


narmol 


NO KM A L 


vmc 


Invprw; 


IWIIKSII 


S992E 


Ha&h 


V\ ASH 


SW30 


npit 


Ntxr 


S9932 


ni^Mvar 


NEXT slnilDniPni wUh a vanablt 


^9934 


krsir 


asBlgn Viiluc In simple string v^kiliibk 


|9M6 


onciT 


om:khcoto 


5993a 


pnum 


lltn 


SW3A 


tnnum 


[N# 


S993C 


redtin 


KJLAD a numcnc value 


S993E 


roads 


HEAD ii string valuo 


S9940 


gcln 


GTT a numcrlf viiluu (Hhciuldn'l bi? iiwd 


S994? 


sets 


liLI astriHE vjiluc 


59*114 


pint 


I'UOT 


S9946 


vlln 


VLIN 


59948 


Klin 


III.lK 


5S94A 


If 


IF 


599 1C 


Inpuin 


LSPUTanurrprlc valup 


S994I; 


inputs 


INl^Ta string valnc 
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JUMP TABLE (ai'itinued} 



AdiSr^i Njme 1 undiim 



/ 



59V5D 


EFTlDin 


print a '7' 


S99S2 


s^ 


CiK 


S9954 


dra* 


DRAW 


SW56 


dnwat 


DKAW wuh flu AT 


59958 


itdrjw 


XDKAW 


5995A 


xdrjw4l 


XLIRAW with an AT 


SMSC 


hpbr 


III'LOT 


S995P 


hplolla 


1 1 PLOT TO 


59960 


slop 


STOP 


S9962 


hculur 


HCOl.Qk 


seyw 


hhib 


HTAB 


S9966 


viab 


VTAB 


S9%9 


caliir 


COIOK 


S99fiA 


speed 


SPf£D = 


I996C 


poke 


I'OKE 


599^ 


Ci.ll 


CALL 


S9970 


hgrt 


HCR2 


SW72 


hgr 


HGK 


S9^1 


scale 


SCALE = 


S997fi 


rol 


KOT = 


S5<>78 


u^r 


USK 


S997A 


p!J 


PIJL 


5W7C 


peek 


PEEK 


S997E 


JeiLnl 


a^tgn value Fd simple inle^cr vnnable 


599ttD 


] clary 


Hbalgn value Id array 


19982 


leislifliy 


a5si|>n vdlue h) siring array 


S99&] 


dim 


DIM 


£9966 


hi mem 


UJMEM 


S99^ 


IcimcEn 


LOMLM 


5998A 


rer.xiind 


K35UME-: 


sgyflc 


arpFyisiind 


& [iiw3onhcin) 


syysE 


wiii2 


WAIT wllh? paramelers 


59990 


wjji:i 


WAIT with 3 paranielers 


5999Z 


def 


DEFFN 


5559-1 


bylf 


by le numeric ccJHslanT 


^ywft 


Integer 


lnlcgcriiunii^r|cfii|i:<^lant 


S995R 


fp 


fltranri; p<iinl cor^tinC 'packed) 


H999A 


liCcr^l 


stnng Eun5tant 


599yc 


ge Invar 


gel V'alueaE numeric vahdbl? 


swyiL 


^tEsvar 


gc>l tfalm-ufsb-mg var 
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Address Nomr 



S99A0 

S9yA2 
S»A4 

S99Afi 

S99AS 
599 A A 

599AC 
S99AE 

S99B0 
599 B2 
599 b4 
S99B6 
599De 
S99BA 
599BC 
S99B[; 

S99CD 

595CZ 
599C4 
599C6 
599CB 
S99CA 
S99CC 
S99CE 

S99D0 
S99Da 
S99D4 
S99D6 
I99D8 
S99DA 
S99DC 
S99DE 

$99Ea 
S99E2 
S99E^ 
S99E6 
S99Ha 
S99^A 
S99HC 



□r 

and 
rt'lop 

^ircomp 
add 

inimB 
linik'd 
div 

power 
nin 

asc 
irhf 

piB 

Icn 
kit 

riBhi 

mid2 
inLdJ 
sir 

abs 
ind 

jnl 
vaL 

concaT 
son 

ftp 

^ 
leg 

exp 

eos 

SlIL 

tan 

am 

gyiiiury 
getnary 
tn 
savroi 



iNoler Arilbmetic c]iprKsi(ms 

art in prefix (Palishl J^irmatrl 



S99H1; orrtir 

599r0 inpul 

S99F3-l9gFP 

UNO OF TASLH 



t miction 

OR 

AND 

lijlallnnal operator delermmed by ihenmlbyle: 

Oi <. 3; <=., 6: =. 9: *>j li >-, 15; > 
sn^inp relilLDnnl operator C^ee above} 
* ^addition] 
- Ibublraction) 
' (multiplicatLun) 
/ (dlvlS]on) 

^ (i?i;ponen1lalion) 

NOT 

ASC 

ClIR! 

POS 
lEK 
lEFTS 
RIG I [TS 

MID5 wiib 2 parjineh?r, 
MIDS ivLlh 3 paramclcrs 
STRS 
AIJ5 

RND 
SGN 
TNT 
VAL 

negate 

-■- (siring conmlpnatton) 

SCKN 

SQR 
LOG 
EXP 
COS 

SIN 
TAN 
ATN 

gi>i value of numeni: array 
gel value of string arr^y 
VK fuser^derined funcnon) 
uve code polnlL^r if RRSL'ME exi^b 
(before each ^latecTLenl ihat can gcneraUr ^m cmir) 
process aik error 

prepare Eora numeric nr string input 
reserved-you louch apd we call Ihe topsl 
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USER-AVAll.ABLE ROUTINES 

Tht' following roulincs an? iiv.iiljbJG to help vou in writing 

aiist^mbly Unguago routinL's ihji will inierljco with Applesoft; 






Name 
MOVSTO 



SMEB BYTE 



S98EE PRTNUM 



S9HFI ERROK 



S9flF4 GEISPA 



S9eF7 



PRIST R 
PKQC 



S9aFD EVAL 



Moves u ahinfi tno [pnglh by [o, musl end wilh □ by le) la 
siring spji:ii ^'hlch haa alrtudy bci^n dllDcalcd h|ih 
"CLTSPA , On ontiy. A = LSB of siring addr.*a and X = 
MSB ot firing addr«s. 

EvalujiK^'; a iiuinL>rLc paniirietcr and vpnTiffi iKat IE la a 
by 1(7 vaJut' <^}-J5,■lh Anylhing clw givcLS ]L1,ECAL 
QUANTITY. The valike i^ relumod in bath A and X. 

Pnnls a numt'dc v^lui^. 5fl. thu carry fTag jf \ho v^Lut is 
floaUn^ polnf Im The l-AC>. !f ihc value is init^gcr, 
dear Ihc ciirv flaji und itu? value sEiould be in X fl-SB) 
and A (MSB)' 

Call? ERROR Ld rcporE an crrur, Xsbduld contain Ibe 
number of Ihe error [rc^^a^p l5« Apptp BASfC 
Rolerence Mflnuul). Ef ON'ERR Is mir t^nnbl^d, Ih*? 
program will iitop and prim the error m^^ngtr 

AJLo^atL'!; tpjce In Ihp string area, A = kngrh of Ihe 
strnR. OnL-QddiiLon^] by It Is allocaled bt^zause iho 
flrel bylc contains the length of the stnng- rul Uw 
string wherp SF6^F7 points. 

Pnnli iheilringpoiniHi loby Sr65l7. 

rnjcrases thp nL"\t siacenient. A |mnp to [his locaiiGn la 
done al the end vi every BASiC stjiemenr. if yuu arc 
roplacinfiii stalemrnt, your code should end with thli 
Evaluates a numeric or string paramctur- 



BG Ffi 



^c-^^ 
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VARIABLES 

VariiiblL*s arc mdicjtpd bv a byte value 1S0(]-FF), The vaTuos for 
thp variables arc accessed by usin^j ihe byte valuo as an mdfi into 
the Mblefl at the addre^scr^ indliait'd by the following pointers: 

vtypp 1S7B): Variable type 

bit7= 1 liaiT^v-Oifnot 

bit 6= I if itnng-DJf numi'ric 

bit 5= 1 if H\ tuser-defincd function) 

bil4- 1 Ifinlcgtf 

blbi0-3 = number of dlmcruioiu If anay 

The fodoivlng Information di:pcnds upon tbo type of variiibl? Involved. 
FP=i1oalLn^ point. L5l!=lcast significant byte, MSB-most signtTicpnt byte. 

vvall (S"A}: Array: L£B of address of jrrav hoadGf 

Siring: LSB of uddrcss of string 
Fr; Non-^eni valuu indicates this is Dojtlng 

point type. Istbyle of padtcci FP value, 
Integer Thifl value Iji ?pro jf vannblc has ar 
Inlegpf value, 

vvflI2 (S7C)! Amy: MSB vf addn-ss tif array header 

Strlngi MSUufaddr&a of siring 
FPiZnd byte d(FP value 
InEeger: l-SD of Integer Value 

walB fS7E); Array: |5B d( address nf array 

FPi 3ii! byle of FP v-ilue 
Integer: MSB byte of integer value 

vvfll4 iiSOy. Airay: MSB of addrejis of array 

FJJ; Jlh byle of I"? value 

WdlS l^E2i'. Array Number □! dim ension^H ifiiot 

dlmen-Sioned veF 
FP: 5th byte pf FP value 

[f Variable AS has a Variable Indizx oE 7. then The following cade would assign 
AS the airing polnled at by ITR- 



LDt 


IZ 


-variable AJ 


LDA 


ETfl 




STA 


(57A).V 


jgtare ;,SE pC eWtess 


Loa 


PTfl-^1 




sra 


i^TO.Y 


:5^g!:e H$B at address 



INDEX 

Address oi prugr^m Ift 

AmpciE^nd (&1 .,....^.... -20 

ApptMdizd m.i^hine code „ 24 

Appk^soft 7A30 

Appli'toll, ch.mging .-.- 13^34 

Batktips - -., 3 

Brtak flt EXXXMncsHfii- 1-1.23 

Chain — -. IS 

Changing programs ,. 13 

Ci)mmflnd5 „„.... 30 

Com filL^ 8,n 

Common mmrnond fSjy 

COMI-ILE CDmmArd .. 11JS.19 

COMPIl FK filti &,26;i7 

COMl^tlEFLSVSTF-M file . fi.26^7 

Concnii-C...„ 14 

CVK files - 19 

Errors ,.. 23-25 

<?>, <#>, <:A>, <*> 24 

Errnr at 5XXXX message ... 23 

Flic Type Misrnjich 25 

Lino nos.H Ltinvi?Tting -.„-,23 

Nd Anders Available 25 

Noi ci CompLli^'d Prograin,25 
Program Too Large .^-.._.25 
Syntax Errur -.„25 



FA5T.]rPLOT program ._ 29 

Giving programs aWay 6 

CV.LE 5 

HrLOTf-pGed.H.,-.,-^-., — ^.29 

I^TRIes 8,n 

J\l'UT.r\\VTI[l\G program 29 
Jn&latlin^ the Com pi lor... 8*27 

Joystick probk-ms .,.„.,... .29 

Licensing ihe Compiler fi 

Mrsu program „ „2fl 

NciTRS program --^..,^7 

Paddle problems 29 

l'PL\T.J.!\K program 23 

Program Writi r B 

Relocaling programs ,...16 

RESTORr: tommand 19 

Running programs^ 10,12.15 

Saving programs ..„, .11 

Suving tipace 27 

Sealing programs - b 

Sl.CJW.I'DL program ...241 

Speed, maximum 17 

Startup program 26,27 

BtoKI. command ^ 19 

Testprocram 9 

Uncompilable commands -.9 
Worms, can of 34 



Dbcla Liner of All Warranties and Liabilities 

RviTt ihough iht'^>[lwjrki dL'un'nii] in iHh rnjnunl h^^ bc^n li^rd ji^ mLcwiti, n>iL}i4'r 
BpiiplEBtoS nor iIb wliw Jit mppljcri tn-iii- Jny wairJUly <.T rfpreft'Olatliin, piDipr piipc*H5oT- 
implied, Weill rtippd 1o lEila miinuji, ihy ^uJlW^lc Jud/nf [h^.'(l)^k^H^; ihmr qualilv. pt'Tfor- 
mani\-, irnithiinliilnljLy. nr blin'^ tcr any pariimlar purpiKp As aiitull, llii.- dukvlL.', fiiilwuv 
ond JTiiinunl an'^^ld "a* i'^," and yuu, lh»' purdia^.T, jil' as^Linini^i ihi- unait' nr,k .ii Lo (hfir 
jpalil^' jnd perioral JT1C1-. Iji no t'Vnrl WlSI Eiiifili' Bci'l. uriti aL|Hw,|^'^uppli^'r-ih€■ tpable [or 
dixecy Lndiriici, inddi'iiiaL PT■■lJ^^tt^Ul-mlnl darragw rMuliinH Erfm any dcfcti in thv ilL'kt'iW. 
M>Fiwdit. o[ mjjiuuL I'Wj-n if ibn'y hjVk'fej^iiiidviiu'd of ihc p«B]b]LLiy o| mih dimiii^t-v. In pjib- 
~Cijl3f,l>WV fhad luv,' no liiihJiLy Iciriin^' pm^nnis ur d j I J SLoTiid In uT USt-d ttHh KhjuLp Mros 
prcdU4:ts, ini-llJiiiPH thi' CmUoE [pfiJWt'rm^ Jif TL'prodlianj; iht-^O jirniirarnB or dii U- Som c al.] ti-» 
dojiol allow dii'tucLukLanurlimlljliiwuf itrrpInsJ ivjrrinlie&or!lifb[liiy lor inodcpliil ortcmai- 
t(Ur[Hiii]ctiimj)^«, Ml ihc jhi^'j? hmltaiiim dt oiduaton may nni apply Lk>yuu. 

AbauL ProDOS: "tTds prcduct Ic^niudifi si^dv^jru. PmOOS. Iicprii>d fram ApptcCcmpuUf, Iiu:. 

Applt nijkc-, nuwatidnllK.i'JlJii'r'-i press i*i imp]]<'d, regarding itw cndowTd ^iw^n- 
E4fkiiBr^ Lb rm-rrhii nliihi ll<v rr Eilnfii for imy purpcGe Soinc^tdlfsdii it^il ulli'w Ihi'i'idu^fn 
crUmllfllion £rftnipln.-d IVJtrinlira or IkhJily ftrr knddi-'nlflllff toiiMHUiTiHiil damages, so Uiia 
Urnitadon iv cKduhinn m jy not apply lo you. 
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Using The Beagle Compiler Witli Extended Memory 



MEMORY TO BURNJ 

The laiest version of the Beagle Compiler takes advanlage of Iwo 
typca of ejcierdeii memory, letting you automatically store 
strings and arrays outside of main f48K) memory. This gives you 
room for larger compiled programs. 



\ Use AUX. SLOT, SYSTEM instead of COMFILER^YSTEM WjtH:^ 

• Apple lJc7;rr7RK"Tre^ '" ^ 

I- AtjpLf JiGSfonlv 126^ wlil he- acrpfLfrf^jl 



■ Applied Lngineermg RamWorks^** (all models) 

■ Checkmate MulTlKam^'^ (all models) 

Use AFFI-IEMEM.SVSTEM instead ofCOMriL|^SVS7EM wiih: 
^ • Appli: Momory Expansion Card'filH^S] 

• Applied Engineering RamFactor 

• Bipsier 

To use one of these system files, transfer it to another disk along 
wilh the file PRODOS. Then boot thai disk. The file you want 
installed during bootup [COM?[LER.5YSTEM, ALTXSI.CT.SYSTliM or 
APPLtMtM -SYSTEM) musi be the first type^YS file whose name 
ends in "^Y^TEM" on the disk. 

To prevent the need to transfer files from the Beagle Compiler 
disk, you could simply rename the two SYSTEM files that you 
don't want to use. Use names that don't end in ".SYSTEM", 

Note: The Beagle Compiler's STARTUP program, if used, will 
report ''COMPFLER^YSTEM installed" regardless of which of the 
three system files has been installed. 

Another Note; APPLRMEM,SY5TEM uses memory more 
efficiently than AUX.SLOTSYsraMH which does not use about 28% 
of the memory available. (Not that you have a choice-the type of 
hardware you have determines which system file you must use,) 

fO STORE OR RESTORE 

Sorry, ProDOS's STOKE and RESTORE commands will not work 
with APPLEMEM SYSTEM Or AUX^LOT5Y5TEM. 



IMPORTANT RAM DISK NOTES 
When you install applemem. system or aux.slot SYSTEM, 
anything stored in a HAM disk will be WIPED OUT . Be sure all of 
your files are copied to a real disk Ersi! 

APPI FMEM-f^ygT^M rannr^t ^p it^pH wtfh 3 tLAJO-ri^fJ^-^ 
^X,SL0TSV5TE M can^econiignrediD-work-with-a RamWorks^ 
or^ultikam RA^^5k._Berc^ what-you do; 



1, W|lh~SASTC .SYSTEM installed {not one of the Compiler's 
SYSTEM programs), run the CONFtCURE.BANKS program and 
specify the minimum and maximum memory banks that wil 
be used by the Compiler. Press RETURN to save a reconfigured 
version of AUX.SLtTTSYSTEM, 

Be sure the range you have selected docs not overlap the 
/ memory that will be used by your RAM disk.* 

2, Use the partition program that came with your RAM disk to 
limit the memory your RAM disk uses. Be sure this memory 
does not overlap the memory used by the Compiler* 

*M(rsE RAM disks don't u^e BankD. Yuu an proiiah\y akip 5lrp7by configuring; 
ilw Compiler En u^ iiniy Ratik (in Ktep Ih»I tuTh mlmmuir artd maximum biO), 

MAXIMUM ARRAV SIZES 

With APFLEMEM .SYSTEM or AUX^LOT.SYSTEM installed, arrays 

may be dimensioned to the following maximum sizes: 

Arra^f type AUX.SLOT. SYSTEM APPiFMFM. SYSTEM 

Real 9419 13106 

Integer 23550 327W 

Siring 15699 21&M 

PROGRAM SPEED 

Your compiled programs may run slightly slower under 
AUX SLOT SYSTEM and APPLEMEM.SYSTEM. The difference in Speed 
will depend mainly upon how much string manipulation your 
Applesoft program does, 

HOW MUCH FREE MEMORY? 

After installing AUX.5LGT.5YSTEM or afplemem.sySTEM, run the 
Applesoft program HOW.MUCH to see how much free memory 
you have for variables. Get ready to see some big numbers! 



